home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / cocojpeg.z / cocojpeg
Text File  |  1998-10-30  |  6KB  |  133 lines
  1.  
  2.  
  3.  
  4. CCCCOOOOCCCCOOOOJJJJPPPPEEEEGGGG((((1111))))                          CCCCMMMMSSSS                           CCCCOOOOCCCCOOOOJJJJPPPPEEEEGGGG((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      cocojpeg - color correct a JPEG/JFIF image file
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _cccc_oooo_cccc_oooo_jjjj_pppp_eeee_gggg [ _----_aaaa _s_o_u_r_c_e__p_r_o_f_i_l_e | _----_ssss _s_o_u_r_c_e__p_r_o_f_i_l_e ] _----_dddd _d_e_s_t_i_n_a_t_i_o_n__p_r_o_f_i_l_e
  13.               [ _----_hhhh ] [ _----_oooo _o_u_t_p_u_t__f_i_l_e ] [ _i_n_p_u_t__f_i_l_e ]
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      _c_o_c_o_j_p_e_g uses the International Color Consortium (ICC) profiles to
  17.      determine how to perform the appropriate color management operation
  18.      ("color correction", hence "coco") upon a JPEG/JFIF image file. The
  19.      operation will be a color space conversion from the input device color
  20.      space to the output device color space.
  21.  
  22.      The device color space associated with the input stream is determined in
  23.      one of four ways. The following approaches are tried in order:
  24.  
  25.      +o    First, if the _----_ssss flag is set, the specified _s_o_u_r_c_e-_p_r_o_f_i_l_e will be
  26.           used.  Specifying _----_ssss will override any profile embedded in the
  27.           source image.
  28.  
  29.      +o    Second, if there is an ICC profile embedded in the source image,
  30.           that will be used.
  31.  
  32.      +o    Third, if the _----_aaaa flag is set, the specified _s_o_u_r_c_e__p_r_o_f_i_l_e will be
  33.           used.  Embedded profiles take precedence over profiles specified
  34.           with _----_aaaa.
  35.  
  36.      +o    Finally, the color management system's default RGB profile will be
  37.           used.  If no default is set, the system searches through
  38.           _CCCC_MMMM_SSSS______PPPP_RRRR_OOOO_FFFF_IIII_LLLL_EEEE______PPPP_AAAA_TTTT_HHHH for the default monitor profile, _mmmm_oooo_nnnn_iiii_tttt_oooo_rrrr_...._pppp_ffff.  If
  39.           that profile is not found, _cccc_oooo_cccc_oooo_jjjj_pppp_eeee_gggg has no way to determine a source
  40.           device profile and so passes the input image stream through
  41.           unchanged.
  42.  
  43.      The output device color space is determined quite simply from the value
  44.      of the _----_dddd flag.
  45.  
  46.      If a full path is not provided for a device profile, the system looks
  47.      through the directories specified in _CCCC_MMMM_SSSS______PPPP_RRRR_OOOO_FFFF_IIII_LLLL_EEEE______PPPP_AAAA_TTTT_HHHH.
  48.  
  49.      If, for any reason _cccc_oooo_cccc_oooo_jjjj_pppp_eeee_gggg is unable to perform the requested
  50.      conversion, the source stream is copied to the destination stream.  Some
  51.      of the reasons that a conversion might not be performed are:
  52.  
  53.      +o    no destination profile was specified;
  54.  
  55.      +o    the number of channels in the input or output profile is not three;
  56.  
  57.      +o    one of the specified profiles could not be found;
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. CCCCOOOOCCCCOOOOJJJJPPPPEEEEGGGG((((1111))))                          CCCCMMMMSSSS                           CCCCOOOOCCCCOOOOJJJJPPPPEEEEGGGG((((1111))))
  71.  
  72.  
  73.  
  74.      +o    one of the specified profiles could not be read;
  75.  
  76.      +o    the source image is one bit deep;
  77.  
  78.      +o    the CMS did not know how to handle one of the profiles;
  79.  
  80.      +o    the CMS needed to read the system RGB profile and could not.
  81.  
  82. CCCCoooommmmmmmmaaaannnndddd LLLLiiiinnnneeee OOOOppppttttiiiioooonnnnssss
  83.      _c_o_c_o_j_p_e_g supports the following command line options:
  84.  
  85.      _----_aaaa _s_o_u_r_c_e__p_r_o_f_i_l_e
  86.                Specifies a profile to be used with images that do not have an
  87.                embedded ICC profile.
  88.  
  89.      _----_dddd _d_e_s_t_i_n_a_t_i_o_n__p_r_o_f_i_l_e
  90.                Specifies a profile for the destination device. The destination
  91.                image file format, including the depth and number of channels,
  92.                will be determined by this profile.
  93.  
  94.      _----_hhhh        Display a usage message.
  95.  
  96.      _----_oooo _o_u_t_p_u_t__f_i_l_e
  97.                The output image file. If this is not supplied, _cccc_oooo_cccc_oooo_jjjj_pppp_eeee_gggg will
  98.                write to standard out.
  99.  
  100.      _----_ssss _s_o_u_r_c_e__p_r_o_f_i_l_e
  101.                The profile for the source device.  This will override any
  102.                profile embedded in the image.  If this profile does not match
  103.                up with the source stream/source file image file format,
  104.                _cccc_oooo_cccc_oooo_jjjj_pppp_eeee_gggg will pass the source through unchanged.
  105.  
  106.      _i_n_p_u_t__f_i_l_e
  107.                The input image file.  If this is not supplied, _cccc_oooo_cccc_oooo_jjjj_pppp_eeee_gggg will
  108.                read from standard in.
  109.  
  110.  
  111. EEEERRRRRRRROOOORRRRSSSS
  112.      Because _cccc_oooo_cccc_oooo_iiii_mmmm_aaaa_gggg_eeee is a filter, it tries to produce valid output if at all
  113.      possible.  However, there are conditions under which _cccc_oooo_cccc_oooo_jjjj_pppp_eeee_gggg will exit
  114.      with an error condition. These are:
  115.  
  116.      +o    a source file was specified, but could not be opened;
  117.  
  118.      +o    a destination file was specified, but could not be opened;
  119.  
  120.      +o    an unrecoverable system error.
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.